home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / misc / Fudgit233.lha / Source / README < prev    next >
Encoding:
Text File  |  1993-12-14  |  4.5 KB  |  107 lines
  1.  
  2.    F U D G I T   Version 2.32
  3.    May 93
  4.  
  5.    Martin-D. Lacasse <isaac@physics.mcgill.ca>
  6.  
  7.    FUDGIT compiles on AIX, DATA GENERAL, HPUX, IRIX, LINUX , NeXT,
  8.    SUNOS, OSF, and ULTRIX.
  9.  
  10.    See the Installation file for compiling.
  11. ------------------------------------------------------------
  12.  Here is a brief description of FUDGIT:
  13.  
  14.  ******** What is FUDGIT? ********
  15.  
  16.  FUDGIT is a double-precision multi-purpose fitting program.
  17.  It can manipulate complete columns of numbers in the form
  18.  of vector arithmetic. FUDGIT is also an expression language
  19.  interpreter understanding most of C grammar except pointers.
  20.  Morever, FUDGIT is a front end for any plotting program supporting
  21.  commands from stdin. It is a nice mathematical complement to
  22.  GNUPLOT, for example.
  23.  
  24.  The main features of FUDGIT are:
  25.     - Command shell including history;
  26.     - Possible abbreviation of all the ``fitting mode'' commands;
  27.     - Possible plural when it makes sense too;
  28.     - Interactive shell supporting flow control (while,
  29.       if-else-endif, foreach);
  30.     - User definable macros;
  31.     - User definable aliases;
  32.     - On-line help;
  33.     - On-line loadable procedure- or function-objects;
  34.     - On-line selectable plotting program;
  35.     - Fourier transforms;
  36.     - Spline interpolation;
  37.     - Smoothing;
  38.     - Double-precision built-in calculator;
  39.     - Built-in interpreter supporting most of C language including
  40.       flow control (if, else, while, for, break, continue);
  41.     - User definable functions and procedures;
  42.     - Double-precision vector arithmetic;
  43.     - Access to the complete C math library;
  44.     - Access to any external C or FORTRAN routines/libraries
  45.       through dynamic loading;
  46.     - Built-in fitting series such as:
  47.         + power series (polynomial);
  48.         + sine series;
  49.         + cosine series;
  50.         + Legendre polynomials;
  51.         + series of Gaussians;
  52.         + series of exponentials;
  53.     - User definable fitting functions;
  54.     - Totally dynamical allocation of variables and parameters;
  55.     - Possible selection of fitting ranges;
  56.  
  57.  FUDGIT has a collection of fitting routines including:
  58.     - straight line (linear) least squares;
  59.     - straight line (linear) least absolute deviation;
  60.     - general linear least squares using QR decomposition;
  61.     - general linear least squares using singular value decomposition;
  62.     - nonlinear Marquardt-Levenberg method;
  63.  
  64.  Refer to the ``User's Manual'' for a complete description and a
  65.  tutorial on I/O and fitting.
  66.  
  67.  ******** The Different Modes ********
  68.  
  69.  FUDGIT is composed of three different modes. These modes can be
  70.  thought of as a C-shell like interpreter linked with a calculator,
  71.  sharing the same variables in memory, and with a plotting program of
  72.  your choice.
  73.  
  74.  The C-shell like interpreter is called the ``fitting mode''. It is
  75.  the central mode and is the one from which all accesses to the disk
  76.  are done. This mode has a range of commands allowing the user to read
  77.  vectors from or save vectors to a data file, to read a command script,
  78.  save the command history, do a Fourier transform of a vector, make a
  79.  linear or nonlinear least square fit, etc... This mode also allows the
  80.  user to define macros and aliases, and to perform plotting-fitting
  81.  batch processes by using some of the built-in flow control commands
  82.  (while, foreach, if-else-endif). All the commands in the fitting mode
  83.  can be abbreviated. It is worth mentioning that in the fitting mode
  84.  the command line parsing is done by analyzing words separated by one
  85.  or more blanks (space or tab), as in an interactive csh.
  86.  
  87.  The ``C-calculator mode'' is a language interpreter supporting most of
  88.  C grammar except pointers. It also supports the complete
  89.  double-precision C math library. Thus, recognized keywords cannot be
  90.  abbreviated, and the different tokens need not be separated. Most of
  91.  the C operators and keywords are understood and a few extra operators
  92.  have been added. This mode does essentially all the possible
  93.  calculations on variables or vectors. Functions and procedures can be
  94.  defined. String variables, string comparison, addition, subtraction
  95.  are also supported by C-calculator mode. This mode is accessed by the
  96.  command `cmode'.
  97.  
  98.  Finally, the ``plotting mode'' is a channel talking directly to the
  99.  plotting program of your choice. Therefore, FUDGIT can serve as a
  100.  front end to any plotting program able to accept input from stdin.
  101.  This way, vectors can be build from the calculator and then plotted by
  102.  your favorite plotting program. The default plotting program is
  103.  GNUPLOT.
  104.  
  105.  Refer to the User's Guide for a complete tutorial and a reference manual.
  106.  
  107.